.. highlightlang:: us

.. index:: @f{ncattfromdata}

.. _@f{ncattfromdata}:

@f{ncattfromdata}
=================

.. us.tag  @f{ncattfromdata} NOTREADYENGLISH fieldfunction

Displays the specified attribute from a netCDF file (nc file). The function
finds the file name via a specified dataset name.

.. function::  @f{ncattfromdata(DatasetName, AttributeName)}
    @f{ncattfromdata(DatasetName, AttributeName, VarName)}

.. us.params

**Parameters**

.. uparam:: DatasetName

   Is the dataset name, e.g. Data1. The name of the selected dataset will be
   displayed in the status bar.

.. uparam:: AttributeName

   Name of an attribute.

.. uparam:: VarName

   Name of a variable. For global attributes this parameter is optional. Default
   value is ``Global``. If you would like to access a channel attribute of one 
   of the datasets channels use one of the following strings:
   ``use_x_channel``, ``use_y_channel``, ``use_z_channel``.   

.. us.example

**Example**

``@f{ncattfromdata(Data1, Origin)}``

**Output**::

   c:\data\test.asc

``@f{ncattfromdata(Data1, units, N)}``

**Output**::

   1/min

.. seealso::
   :ref:`overview-field-functions`,
   :ref:`editupdate-fields`,
   :ref:`diagraminsert-field-function`,
   :ref:`@f{ncvaluefromdata}`

:sub:`id-1069298`